home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmgetindom.z / pmgetindom
Text File  |  1997-04-03  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMGGGGEEEETTTTIIIINNNNDDDDOOOOMMMM((((3333))))                                                    PPPPMMMMGGGGEEEETTTTIIIINNNNDDDDOOOOMMMM((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm - get instance identifiers for a performance metrics instance
  10.      domain
  11.  
  12. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  14.  
  15.      iiiinnnntttt ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm((((ppppmmmmIIIInnnnDDDDoooommmm iiiinnnnddddoooommmm,,,, iiiinnnntttt ********iiiinnnnssssttttlllliiiisssstttt,,,, cccchhhhaaaarrrr ************nnnnaaaammmmeeeelllliiiisssstttt))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      In the current Performance Metrics Application Programming Interface
  21.      (PMAPI) context, locate the description of the instance domain _i_n_d_o_m, and
  22.      return via _i_n_s_t_l_i_s_t the internal instance identifiers for all instances,
  23.      and via _n_a_m_e_l_i_s_t the full external identifiers for all instances.  The
  24.      number of instances found is returned as the function value (else less
  25.      than zero to indicate an error).
  26.  
  27.      The value for the instance domain _i_n_d_o_m is typically extracted from a
  28.      _p_m_D_e_s_c structure, following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular
  29.      performance metric.
  30.  
  31.      The resulting lists of instance identifiers (_i_n_s_t_l_i_s_t and _n_a_m_e_l_i_s_t), and
  32.      the names that the elements of _n_a_m_e_l_i_s_t point to, will have been
  33.      allocated by ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm with two calls to mmmmaaaalllllllloooocccc(3C), and it is the
  34.      responsibility of the caller to _f_r_e_e(_i_n_s_t_l_i_s_t) and _f_r_e_e(_n_a_m_e_l_i_s_t) to
  35.      release the space when it is no longer required.
  36.  
  37.      When the result of ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm is less than one, both _i_n_s_t_l_i_s_t and
  38.      _n_a_m_e_l_i_s_t are undefined (no space will have been allocated, and so calling
  39.      ffffrrrreeeeeeee(3C) is a singularly bad idea).
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmm(3) and ppppmmmmNNNNaaaammmmeeeeIIIInnnnDDDDoooommmm(3).
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      PPPPMMMM____EEEERRRRRRRR____IIIINNNNDDDDOOOOMMMM
  46.           _i_n_d_o_m is not a valid instance domain identifier
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.